JSMail is an SMTP/POP3 server. The content of this Zip is shareware
and as such is freely distributable provided that this and all the 
other files that came with JSMail are distributed along with it.

The software 'JSMail' is Copyright (c) 1996-1999 John Sargent.
The software remains the sole and exclusive property of the copyright
holder.

JSMail is licenced 'as is' and without warranties expressed or implied as
to its performance or merchantability or any other warranties. No warranty 
of fitness for a particular purpose is offered.


JSMail is shareware. If you find it useful and continue to use it, you
should register it, paying the appropriate fee. The fees for licences
are given in the file 'licence.txt'.

The unregistered version restricts you to 5 mail drops - the number of 
maildrops in the registered version depends upon the licence you purchase.


Installation
------------
This is a 32 bit console program, and hence requires Win95 or NT.

There is no installation needed as such. All that is required is that
an appropriate directory structure is in place, tcp/ip is functioning
and you have the appropriate files.

The individual maildrops are all kept in their own subdirectory from
a root maidrop directory ( [MBOX] ). 

        [MBOX] -
                |
                |-[USER1]
                |
                |-[USER2]
                |
                   etc

There should be a directory that will contain the mails waiting to be
routed ( [QUEUE] ).

There should be a directory that will contain the mails waiting to be
sent to the smarthost ( usually your ISPs SMTP server ) [OUTBOUND].

The suggested layout for all the files is...


    [JSMAIL] ---
    mail.exe    |
    mail.conf   |
    passwd      |
    responders  |
                |
                |- [MBOX] -
                |          |
                |          |-[USER1]
                |          |
                |          |-[USER2]
                |          |
                |             etc
                |
                |-[QUEUE]
                |
                |-[OUTBOUND]



The password file ( passwd ) contains all the valid users passwords and 
aliases. See 'files.txt' for the format for entries in this and other
configuration files.

Passwords can be changed by the users by telneting to password port
(defaults to 23 )

Starting
========
On windows 95, the program is started 

    mail

you can optionally give the configuration file as an argument. If you
do not, mail.conf is assumed.

    mail c:\jsmail\mail.conf

Under NT, you must also add -console

    mail -console
or  mail c:\jsmail\mail.conf -console


NT Service
==========
JSMail can be installed as a service under NT. At the
comand prompt enter

    mail [config_file] -install [service_name]

config_file defaults to mail.conf and service_name defaults
to JSMail. It can be installed several times under different
service names. This is useful for mult-homed machines and each
instance of JSMail is to run bound to a different address.

To start the service, either use the control panel services applet
or at the prompt enter
    net start JSMail

Once installed, it can be removed by entering
    mail -remove  [service_name]


System Tray
===========
JSMail can be run in the system tray - specify -tray on the 
command line

    mail mail.conf -tray

or at the JSMail> promtp, enter 'tray'.

When running in the tray, double left clicking on the icon
will restore the console. Double right clicking will terminate
JSMail.


Commands
========
Various commands are available at the jsmail> prompt - type help
or see the 'commands.txt' file enclosed.

Encrypted data
==============
There is an option to have data files stored in an encrypted format.
This allows for running on machines that have no file-level security
( win95/98 ). The contents of users mailboxes, the outbound queue
and intermediate temporary files can all be in an encrypted form,
so that even with access to the directories, people still cannot
read the contents of others mails. If encryption is enabled, JSMail
will expect all data files to be in an exncrypted form; if there
are already data files in a users mailbox or in the queue/outbound
directories, they should be encrypted using the xlat.exe utility
BEFORE JSMail is started with encryption enabled.


General
=======

Utilities
---------
XMAIL -  a command-line utility to send mail to an SMTP
server. The text to be sent can either be entered at the
prompt or redirected in from a file.

MBOX2SMTP - a remote-control utility that allows single
commands to be sent to the server from the command-line (mailcmd.exe),
and a utility to read a standard unix mbox file and send it to an 
smtp server.

XLAT - a command line utility to encrypt/decrypt mailbox
data files.

JSMC - configuration file compiler. This turns the schedule,
pop3 accounts and main config files into binary format, making
them more secure.


Please ensure you have the TZ environment variable set up correctly. This
tells various programs about the timezone you are in.

For Britain, this would be something like TZ=GMT0BST1 if your machine is
set to use British Summer Time, or TZ=GMT0 if not.

If it is not set, it defaults to Pacific Standard Time (PST8PDT).


Support is available free via email from:
    jsmail@j-bg.demon.co.uk